home *** CD-ROM | disk | FTP | other *** search
/ Linux Cubed Series 4: GNU Archives / Linux Cubed Series 4 - GNU Archives.iso / gnu / enscript.4 / enscript / enscript-1.4.0 / README < prev    next >
Encoding:
Text File  |  1996-06-13  |  5.0 KB  |  135 lines
  1.  
  2.                  GNU Enscript
  3.                  ============
  4.  
  5. GNU enscript is a drop-in replacement for the enscript program.
  6. Enscript converts ASCII files to PostScript and stores generated
  7. output to a file or sends it directly to the printer.  
  8.  
  9. Enscript is free software; you can redistribute it and/or modify it
  10. under the terms of the GNU General Public License as published by the
  11. Free Software Foundation; either version 2, or (at your option) any
  12. later version.
  13.  
  14. Enscript is distributed in the hope that it will be useful, but
  15. WITHOUT ANY WARRANTY; without even the implied warranty of
  16. MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the GNU
  17. General Public License for more details.
  18.  
  19. You should have received a copy of the GNU General Public License
  20. along with enscript; see the file COPYING.  If not, write to the Free
  21. Software Foundation, 59 Temple Place - Suite 330, Boston, MA
  22. 02111-1307, USA.
  23.  
  24.  
  25. * Supported Character Sets
  26.  
  27. Enscript supports following character sets:
  28.  
  29.   - ISO-8859/1        ISO latin1 (default)
  30.   - ISO-8859/2        ISO latin2
  31.   - ISO-8859/3        ISO latin3
  32.   - ascii        7 bit ascii
  33.   - ascii scands    7 bit ascii with following encodings:
  34.               '{'  = Σ (adieresis)
  35.               '|'  = ÷ (odieresis)
  36.               '}'  = σ (aring)
  37.               '['  = ─ (Adieresis)
  38.               '\\' = ╓ (Odieresis)
  39.               ']'  = ┼ (Aring)
  40.   - IBM/PC        standard PC/DOS character set
  41.   - Mac            Macintosh character set
  42.   - VMS            VMS multinational charset
  43.   - hp8            HP Roman-8 charset
  44.   - ps            PostScript font's default encoding
  45.   - pslatin1        PostScript interpreter's `ISOLatin1Encoding'
  46.  
  47. * Special Escapes
  48.  
  49. Enscript supports special escapes sequences that can be used to add
  50. simple page formatting commands to ASCII documents.  User can inline
  51. EPS files, change font on-the-fly insert comments and shade regions of
  52. text.  See file README.ESCAPES for details.
  53.  
  54.  
  55. * PostScript font support
  56.  
  57. ** AFM files
  58.  
  59. Enscript supports AFM (Adobe Font Metrics) files.  AFM files contain
  60. font metrics information (character widths, etc); if there is an AFM
  61. file for the current font, enscript can count line widths and tab
  62. stops correctly.  Enscript distribution contains AFM files for the
  63. most common PostScript fonts.  These AFM files are installed to the
  64. directory <prefix>/share/enscript/afm/.
  65.  
  66. ** Fonts (.pfa or .pfb)
  67.  
  68. Enscript supports also additional PostScript fonts which are defined
  69. in the `.pfa' or `.pfb' font files.  Enscript automatically
  70. down-loads font's description to your PostScript document whenever you
  71. use an external disk font.  Font down-loading requires that you have
  72. both the `.afm' and `.pf{a,b}' files for you extra fonts and you have
  73. created a font mapping file called `font.map' to your font directory.
  74.  
  75. These are the steps that are needed to make your extra fonts usable in
  76. enscript:
  77.  
  78. 1) Install the `.afm' and `.pf{a,b}' files to some appropriate
  79.    directory.  Note! for a single font, both the .afm and .pf{a,b}
  80.    files must have  the same prefix, filenames can differ only from
  81.    the suffix part.  For example, if font `FooFont' is defined in the
  82.    file `foo.pfa', then the AFM file must be named `foo.afm'.  
  83.  
  84. 2) Create a font map file for the font directory.  Enscript's
  85.    distribution has an utility called `mkafmmap' which does the job;
  86.    just give command:
  87.  
  88.     mkafmmap *.afm
  89.  
  90.    in your font directory.  This command creates a file called
  91.    `font.map' to your font directory.  File contains one row for each
  92.    .afm file, each row has two columns: font's PostScript name and
  93.    the prefix for the corresponding .afm file.
  94.  
  95. 3) Notify enscript that it has new fonts to play with.  This is done
  96.    by editing the global configuration file `enscript.cfg' or the
  97.    personal configuration file `$HOME/.enscriptrc'.  Global
  98.    configuration file has an entry called 'AFMPath' which contains the
  99.    current font search path.  Add your new font directory to this
  100.    path:
  101.  
  102.     AFMPath: /usr/local/share/enscript/afm:/usr/local/lib/ps:/usr/lib/ps:/fonts/myfontdir
  103.  
  104.   where `/fonts/myfontdir' is the new font directory.
  105.  
  106. So how does the font down-loading work?  Enscript automatically
  107. down-loads font files for header and body fonts, if it can find the
  108. corresponding `.pfa' or `.pfb' files from the AFMPath.  Enscript do
  109. *not* down-load fonts that are specified in `^@font' escapes, however
  110. you can down-load these font by specifying command line option
  111. `--download-font=name' for each font.  You can also specify
  112. down-loadable fonts in the global configuration file `enscript.cfg'
  113. or in your personal configuration file `$HOME/.enscriptrc' by giving
  114. option `DownloadFont: name'.
  115.  
  116.  
  117. * What's different as compared to the Adobe's Enscript application?
  118.  
  119. - Adobe enscript's option `-o' has been changed.  In Adobe enscript
  120.   option `-o' lists missing characters.  In GNU enscript `-o' is an
  121.   alias for `-p' and missing characters are listed with an option `-O'.
  122.  
  123.  
  124. * Misc
  125.  
  126. I am dedicated to make the GNU enscript the best a2ps converter ever,
  127. this includes adding all the GNU features and cookies to it ;)
  128.  
  129. Comments, suggestions, bug fixes, bug reports, etc. are welcome.
  130.  
  131.  
  132.     Markku Rossi 
  133.  
  134.     <mtr@iki.fi> <http://www.iki.fi/~mtr/>
  135.